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PREFACE 


This manual describes the operation and use of the PDP-15 PATCH Utility 
Program. The PATCH program may be operated in either the ADVANCED 
Software System CADSSl or the Disk Operating System (DOS) environment. 

NOTE 

In DOS systems, PATCH may be used only by the 
System Manager. 

It was assumed in the preparation of this manual that the reader was 
familiar with the operation of the PDP-15 equipment and the contents 
of the software manual describing the features of the particular 
monitor system in which he was operating, that is: 

a) for ADSS users, PDP-15/20/30/40 ADVANCED Monitor 
Software System Manual, DEC-1 5-MR2B-D ; 

b) for DOS userii, DOS Software System User's Manual, 

DEC-1 5-MRDA-D. 


PDP-15 UTILITY PROGRAMS MANUAL, DEC-15-YWZB-D 


The PDP-15 Utility Programs manual is comprised of a set of individual 
manuals, each of which describes the qjeration and use of a PDP-15 
Utility Program. The manuals which make up the Utility Programs set 
are listed in the following Application Guide. In addition, the Appli- 
cation Guide also indicates the order number of each manual and the 
specific PDP-15 Monitor Software Systems in which the program described 
may be used. 

The Utility Manuals may be ordered either individually, by using the 
title and order number given with each manual or as a set by referenc- 
ing "PDP-15 Utility Programs Manual, DEC-15-YWZB-D" . 
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APPLICATION GUIDE 


PDP-15 UTILITY PROGRAM MANUALS 


PDP-15 Utility Program Manuals and the Application of Each 



Manual 

Applies to Monitor: 

Title 

Order Number 
CDEC-15-YWZB_) 

DOS 

ADV 

B/F 

DDT 

Utility Program 

DNl 

/ 


/ 

CHAIN & EXECUTE 
Utility Program 

DN2 

/ 

/ 

/ 

SGEN 

ADVANCED Monitor 

DN3 


/ 


MTDUMP 

Utility Program 

DN4 

/ 

/ 


PATCH 

Utility Program 

DNS 

/ 

/ 

/ 

EDIT 

Utility Program 

DN6 

/ 

/ 

/ 

UPDATE 

Utility Program 

DN7 

/ 

/ 

/ 

LINKING LOADER 

DNS 

/ 

/ 

/ 

PIP 

ADVANCED Monitor 

DN9 


/ 

/ 

SRCCOM 

Utility Program 

DNll 

/ 

/ 

/ 

SGEN 

DOS Monitor 

DN12 

/ 



PIP 

DOS Monitor 

DN13 

/ 



Disk SAVE/RESTORE 
Programs 

DNl 4 

/ 

/ 

/ 
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SECTION 1 


INTRODUCTION 


1 . 1 PATCH PROGRAM 

The PATCH Utility program enables the PDP-15 user to view and modify 
System Programs and data on specific device data blocks. The commands 
provided by PATCH may be entered via the console keyboard or, in the 
monitor Batch mode, via either paper tape or card reader units. This 
manual is concerned only with user-controlled PATCH operations. The 
operation of PATCH under monitor Batch control is described in the 
applicable monitor (ADSS or DOS) reference manual (see Table 1-1) . 

1.2 MANUAL ORGANIZATION AND USE 

This manual is intended for users who are familiar with: 

a) the general operating procedures (i.e., use of equip- 
ment and startup procedures) , 

b) the elements, structures and use of the particular 
monitor software system in which PATCH is to be used. 

Introductory information and detailed descriptions of each PATCH 
function and their agjlications are given in Sections 2 through 5. 

Section 6 summarizes the PATCH startup and operating procedures. 

New users of PATCH should familiarize themselves with the contents 
of Sections 1 through 5; thereafter, they need only refer to Section 
6 for concise information. 

Two Appendices are included which contain supplementary System Block 
(SYSBLK) and System Program descriptions. 

SYSBLK is described in Appendix A, System Programs are discussed in 
Appendix B. 
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1 . 3 SUPPORTING DOCUMENTS 


Table 1-1 lists PDP-15 documents which either support directly or con- 
tain information useful in understanding PATCH and its functions. 

Table 1-1 

Supporting Documentation 



TITLE 

ORDER NUMBER 

ADSS Manuals 


al 

ADVANCED Monitor Software System 
for PDP-15/20/3Q/40 

DEC-15 -MR2B-D 

bl 

PDP'^15/20 User's Guide 

DEC-15-MG2B-D 

c} 

SGEN ADVANCED Monitor Utility Program 

DEC-15-YWZB-DN3 

DOS Manuals 


al 

DOS User's Manual 

DEC-15-MRDA-D 

b) 

DOS Keyboard Command Guide 

DEC-1 5-NGKA-D 

cl 

SGEN-DOS Utility Program 

DEC-15-YWZB-DN12 

dl 

DOSPIP Monitor Utility Program 

DEC-1 5-YWZB-DN13 

B/F Monitor Manual 


al 

PDP-15/30, PDP-15/40 B/F 

Monitor Software Systems 

DEC-15-MR3A-D 

Common 

Manual 


a) 

MACR015 MACRO-Assembler Program 

DEC-15-AMZC-D 


1.4 MAJOR PATCH FUNCTIONS 

The items on which PATCH functions may be performed together with a 
description of the commands and procedures needed for their selection 
are given in Section 2. 
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The major functions for which PATCH may be used are: 


a) the loading of relocatable programs into a system as 
a System Program (described in Section 3); 

b) the loading of absolute programs and data onto a 
System Program area (described in Section 4) ; 

c) the modification of registers located in 

li System Programs, 

21 Data blocks, 

31 System SYSBLK (system block) . 

1.5 PATCH, I/O DATA FLOW PATHS 

Figure 1-1 illustrates the primary data flow paths employed during 
PATCH operations . 

User command/response operations are carried out via a console/printer 
unit. Peripheral devices/UFD ' s containing the files to be patched 
must be assigned to .DAT-14, those devices containing auxiliary input 
files must be assigned to .DAT-10. 
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Figure 1-1 PATCH Operations, Information 
Flow Diagram 
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SECTION 2 


SELECTION OF ITEM TO BE PATCHED 


2.1 SELECT FUNCTION 

TB.e first step required in any PATCH procedure is the selection of the 
item (.DAT ’-14} to be patchel. Two basic commands "Program Select", 
and "Block Select" are provided for this purpose. 

2.1.1 Program Select Command 

The System Programs located on the device assigned to .DAT -14 are 
selected for PATCH operations by the entry of a unique name which is 
stored in a monitor table; these unique names enable the monitor to 
identify the requested program. 

The format for a Program Select command is : 


For example, to select the Editor program the entry 
>EDIT ) 
is entered . 

The entry of a System Program name merely identifies the item to be 
operated upon; no further action is taken until a PATCH function is 
initiated by another command. 


NOTE 

The Program Select command may be used only if 
the device assigned to .DAT -14 contains a Sys- 
tem Block (SYSBLK) . 

In addition to System Programs, system Device System Block (SYSBLK) 
and CTRL Q (fQAREA) areas may also be selected for PATCH operations. 
Table 2-1 lists the unique names of the programs normally supplied as 
System Programs with ADSS and DOS software systems. 
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TABLE 2-1 


PATCH Accessible System Programs 

MONITOR 



PROGRAM 

NAME 

DOS 

ADSS 

1) 

Resident Monitor 

RESMON 

/ 


21 

System Loader 

.SYSLD 

/ 

/ 

31 

Control Q Area 

+QAREA 

/ 

/ 

41 

Standard Editor Program 

EDIT 

/ 

/ 

5] 

Text Editor for VT15 Graphics Display 

EDITVT 

/ 

/ 


Text Editor for VP15 Storage Tube 
Display Unit 

EDITVP 

/ 

/ 

71 

Peripheral Interchange Program 

PIP 

/ 

/ 

8) 

Macro -Imbedded Assembler for 8K 

Systems Only 

MACRO I 


/ 

9) 

MACR015, Macro-Assembler Program 

MACRO 

/ 

/ 

10) 

Cross Reference Program 

CREF 

/ 

/ 

11) 

CHAIN and EXECUTE Program 

CHAIN 

/ 

/ 

121 

System Generator 

SGEN 

/ 

/ 

131 

System Generator, Section 2 

.SGEN2 


/ 

14) 

System Generator, Section 3 

. SGEN3 


/ 

15) 

FORTRAN IV (16K) 

F4 

/ 

/ 

16) 

FORTRAN IV Imbedded (8K Systems Only) 

F4I 


/ 

171 

Core Dump Utility Program 

QFILE 

/ 


18) 

Dump Core Program 

DUMP 

/ 

/ 

19) 

DECtape Copy Program 

DTCOPY 

/ 

/ 

201 

PATCH Program 

PATCH 

/ 

/ 

211 

UPDATE Program 

UPDATE 

/ 

/ 

221 

Source Compare Program 

SRCCOM 

/ 

/ 

23) 

Task Builder Program (RSX Only) 

TKB 

/ 


24) 

DOS Monitor 

DOS 15 

/ 


25) 

Keyboard Monitor, KM-15 

KM15 


/ 

26) 

9-15 Keyboard Monitor, KM9-15 

KM9-15 


/ 
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2.1.2 Block Select (B) 

A single 400g-word data tiock located on the device assigned to .DAT -14 
is selected for PATCH operations, using a "B" Block Select command. 

FORMATS: a) ^ 

or 

bi >B+. .n ^ (DECtape only) 
or 

cl >B-. .n p CDECtape only) 

where: 

11 B identifies the Block Select command 

21 + indicates the selected block should be read 

in the forward direction. 

31 - indicates that the selected block should be 

read in the reverse direction 

41 n represents an octal number which identifies 

a logical block on the PATCH I/O device (.DAT -14) . 

The value of n must be greater than or equal to 

0 . 

DESCRIPTION: 

The entry of a "B" select command relocates the identified word block 
into a PATCH Block Buffer in core. In relocating the block, the load 
address is set to 0, the size is set to 400g, and the block number is 
as specified. If the block number (n) in any of the select commands 
is followed by a space, any data on the remainder of the input line is 
treated as a comment and is ignored. For example: 

>B^l^fj2( ^COMMENT J 

is permitted. 
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SECTION 3 


LOADING RELOCATABLE PROGRAMS AS SYSTEM PROGRAMS 

3.1 PATCH LOAD FUNCTION 

A PATCH load function enables the user to convert a relocatable file 
into an absolute SYS file format and load the converted file onto a 
system device as a System Program. The PATCH command used, the proce- 
dure required, the relocatable file requirements, and the operations 
performed by PATCH are described in detail in this Section. 

The PATCH load function can only be used when the system on .DAT -14 
has been prepared by SGEN to receive the converted file. During SGEN 
procedures (refer to appropriate SGEN manual) the user must enter the 
name of each program to be installed, specify .DAT slot usage, and 
indicate the order in which the System Programs are to appear in the 
newly generated system. The program name, size, and .DAT slot usage 
information entered during SGEN is stored in the system device SYSBLK. 

3.2 PATCH READR LOAD COMMAND 

The command "READR" initiates the PATCH relocatable-to-SYS file pro- 
gram load function. The general format of this command is as follows: 

>READR [nnnnnj [filename] [ext] [comments] ) 

where : 

nnnnn = the highest 13 -bit core address to be occupied by 
the relocated file when it is loaded into core as 
a SYS file. If an address is not specified, the 
first free register below the bootstrap is assumed 
by PATCH. If specified, the value of nnnnn must 
be ^17636g; a larger value will cause an error. 

filename the name of the relocatable file.^ 

ext = filename extension; if not given, BIN is assumed. 

comments if desired, a comment may be added to the command 

string, but only if the extension is given explicitly. 

^NOTE: FILE name may be om.itted for non-file oriented auxiliary 

devices (.DAT - 10 ), 
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3.2.1 Procedures 


TEie READR command must be preceded by a program select command which 
identifies the system device area (named in SGEN) into which the modi- 
fied file is to be written. For example/ the sequence; 

> 8TRN ) 

> READR 8TRAN ) 

must be entered to install the file 8TRAN onto a prepared system de- 
vice at .DAT-14/ given the name 8TRN. 

On the execution of a READR command/ PATCH obtains the named file from 
.DAT-lj2f and checks it for required size and program characteristics 
(see paragraph 3.2.2). If the file is not acceptable, the load opera- 
tion is halted and an appropriate error message is output to the user. 

If the file is acceptable, PATCH relocates addresses within the input 
file, builds a table of the transfer vectors contained by the file, 
and appends the table and a Bank Bit Initialization routine to the 
file. The modified file and its appended routine and vector table are 
tfien loaded as a unit, in core image form, onto the system device at 
.DAT-14. 


PATCH automatically changes the patch parameters in SYSBLK. Relocation 
and the Bank Bit Initialization routines are described in paragraphs 
3.3 and 3.4, respectively. 


3.2.2 Input File Requirements 

In order to be installed onto a system as a SYS file, a relocatable 
file at .DAT-lj2( must: 

1) not contain more than 256 transfer vectors; 

2) not contain external .GLOBL references; 

3) not use indexed instructions 

4) not have a core image size greater than the number of 
system blocks allocated multiplied by 4j30fg. 

5) not cause the total program size to exceed 8K. 

6) not contain COMMON references 
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NOTE 


The total installed size of a program may be computed 
by adding 1) the size of the binary program, 2) the 
nximber of transfer vectors, and 3) 32g word locations 
which are occupied by the Bank Bit Initialization 
routine. 


3.3 RELOCATION 

MACRO-15 outputs relocatable programs addressed as if they were as- 
sembled starting in location 0 of core. Relocatable programs are 
normally loaded into core for execution by the Linking Loader System 
Program which, at load time, computes the difference between the 
MACRO-as signed addresses and the addresses of the actual core area 
into which the program is to be loaded for execution. This computed 
difference, called the relocation factor, is then added to each loca- 
tion address contained by the program as it is loaded into memory. 

The relocation factor properly orients the relocatable program within 
memory . 


3.3.1 PATCH READR File Relocation 

During the execution of a READR command, PATCH calculates the required 
13-bit relocation factor by subtracting the program size from the 
final (highest) address the program is to occupy. The final address 
is either specified in the READR command by the user or, by default, 
17636g is assumed. 

The relocation factor, recognized by PATCH as the symbol #, is then 
incremented by 1 for each word location and the resulting value as- 
signed as the address of the location. For example, the relocation 
factor (#) for a relocatable program 400 ^ words in size with no address 

O 

specified in the READR command would be calculated: 

# = 17636g - 400g + 1 = 17237g 

In order to relocate the program addresses (0 through 377) for con- 
version to the absolute values required for SYS files, PATCH then 
increments the relocation factor by 1 for each position and assigns 
each value obtained as an address to the corresponding program word 
location; i.e.. 
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# + 0 = address of first word location (17237g) 

# + 377 = address of last program word location (1763 6g) 

PATCH also relocates the addresses contained by the memory reference 
instructions and transfer vectors found in the input program. 

3.4 BANK BIT INITIALIZATION (BBI) ROUTINE 


Transfer vectors contain IS-bit addresses which include bank identity 
bits in addition to the 13 -bit, 8K word location addresses. The format 
of a Transfer Vector data word and the interpretation of its address 
portion is ; 



BANK 


0 

1 

2 

3 



BANK I 
BITS I 

I , 


0 

1 

0 

1 


13 -bit BANK WORD LOCATION ADDRESSES 


— ►OOOOOp to 17777„ 
— ► 20000^ to 37777p 
— ► 40000^ to 57777p 
— ► eOOOOg to 77777g 


During READR relocation operations the relocation factor is added to 
the least significant 13 word bits of the Transfer Vector to relocate 
the bank word address which it contains. The bank bits of a Transfer 
Vector cannot be relocated at the time the file is installed as a System 
Program since the number of the highest bank of a system varies ac- 
cording to the overall size of the system. 


To ensure that transfer vector bank bits are relocated prior to run 
time, PATCH, during READR operations, develops a table of transfer 
vector locations, adds the table to a Bank Bit Initialization routine, 
and appends the routine to the input program. The BBI routine is 
installed onto the system device medium as part of the new System 
Program. 


When a READR-ins tailed program is loaded into core, its associated 
BBI is also loaded immediately below Ihe program (see Figure 3-1). 

The loader, .SYSLD, on completion of its functions, turns control 
over to the BBI routine. The BBI routine determines what bank the 
System Program has been loaded into and updates the bank bits of all 
Transfer Vectors contained by the program. The routine identifies 
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the vector words from the Transfer Vector table developed during 
PATCH READR operations. 

On completion of its initialization function, this routine sets the 
contents of the .SCOM+3 pointer to ftie address of the last word loca- 
tion occupied by the routine and turns control over to the System 
Program. 

The modification of .SCOM+3 at the end of BBI functions frees the 
core occupied by this routine for use by the System Program. 

The basic portion of the BBI routine requires 32g word locations. 

The routine Transfer Vector table requires an additional location for 
each Vector in the program. A maximum of 400 g vectors is pemitted. 

The PATCH appended BBI routine relives the user of the responsibility 
of including a routine to perform this function. 

3.5 READR ESTABLISHED SYSTEM COMMUNICATIONS AREA 

The ability to specify in the READR command the highest load address 
for the program being loaded permits a buffer area to be set up 
between the last program address and the first address of the boot- 
strap. Such a buffer would provide READR-loaded programs with a 
common core-resident buffer for intra-program communications and/or 
common data storage. 
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3.6 LOADING PATCH-RELOCATED CORE IMAGE SYSTEM PROGRAMS 


READR- ins tailed Systems Programs and their associated Device Handlers 
are loaded into core from the system device by the System Loader 
(.SYSLD) program. 

The placement of READR-installed System Programs and their device 
handlers in core is illustrated in Figure 3-1. 
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LEGEND: 


I EXTRA ^ j 

i 4K PAGE [ 

I i 



N is : 

00000 for 8K 
20000p for 16K 
40000^ for 24K 
eOOOOg for 32K 


17777„ + N 
o 


17636g + N 


.SCOM + 3 Adjusted value 
after BBI initialization 
operation 


•SCOM + 3 Initial Value 


00020Q + N Lowest Limit for 

SYS file $ initializa- 
tion routine 


.SCOM + 2 


.SCOM + 1 


^An extra 4K page is not used for 
loading core image programs, 
it is used only for handlers. 


Memory Map, Loading a P^A.DR-Installed 
SYS-file on the ADSS Monitor 
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SECTION 4 


LOADING ABSOLUTE PROGRAMS AND DATA 


4.1 READ AND PATCH FILE FUNCTIONS 

TElls section contains detailed descriptions of the READ load function, 
the function user commands, and the load operation. Patch files, the 
input sources to PATCH during READ load function, are also described 
in detail. 


4.2 READ LOAD FUNCTION 


The "READ" load function enables the user to transfer absolute "Patch 
files" from the auxiliary input device (.DAT-10) into a user-selected 
program or data block located on the device at .DAT -14. 

A Patch file is an absolute program written by the user to operate with 
the PATCH READ load function; its purpose is to direct the PATCH program 
in loading information contained by the file into a specific register 
or series of registers located within a program or data block of the 
device on .DAT-14. Entire programs or data blocks, as well as selected 
items, may be loaded from Patch files onto the device at .DAT-14, using 
the PATCH READ load function. 


Patch files are used as a means of making changes (i.e. patches) to 
SYS files or a device data block or of installing a new version of a 
System Program onto a system device. They are particularly useful when 
the same patches are to be made to a SYS file contained by more than 
one system device. 

NOTE 


When patching or replacing a System Program, care 
must be taken to ensure either that the existing 
SYSBLK parameters are not affected or that they 
are changed to comply with the characteristics of 
the replacement version of the program (see 
paragraph 4.5). 


4.3 READ COMMAND 


The command READ initiates the performance of the absolute load 
function. This command may have any of the following formats: 


a) >READ^ (for non-director ied devices only ) 

b) > READ i_j[ filename]^ 

c > READ i_j[ filename]i_j[ ext 
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where : 


1) filename is the name of the Patch file to be input 
from .DAT-10. The use of a filename extension 
(format c) is optional. If not given, the extension 
is assumed to be ABS . 

2) Comments may be added to command strings having the 
format shown in item c. 

3) Patch files on paper tapes do not require a 
filename (see item a) . 

NOTE 


The READ command must be preceded by either a 
Program Select or Block Select command. The 
patch file read must be a .ABS macro program. 


4.3.1 READ Load Operation 

During READ command load operations, PATCH loads into core one 400 

O 

word block at a time from both the Patch File and the selected program 
or data block. Once both blocks are loaded, PATCH processes in 
sequence each word of the Patch File block. Using reference data 
supplied in the Patch File, PATCH determines the address within the 
user selected program or data block which corresponds to that 
addressed by the Patch File word being processed. If the addressed 
register is within the selected program or data block currently in 
core, the contents of the Patch File word are loaded into that 
register by PATCH. 

If the addressed register is not in the block currently in core, the 
block in core is written back into the device at .bAT-14 and the block 
containing the addressed register is loaded. After the new block is 
loaded, PATCH locates the addressed register and writes the contents 
of the Patch File word into it. 

A user-selected data block is handled, during READ operations, as if 
it were an absolute program having addresses ranging from 
through 00311 ^, If more than one data block is to be patched, a 
separate Patch File is required for each block and individual Select . 
Block and READ commands must be issued for each. 

If a Patch File word addresses a location not within the limits of 
the selected program or block, PATCH outputs an ADDRESS OUT OF 
RANGE error to the user console teleprinter (refer to Section 6 
for description of error messages) . 
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4,4 WRITING PATCH PROGRAMS 

The following is an example of the proper format for a PATCH assembly 
source program to be assembled and output by MACR0~15 : 


PATCH FILE 


.TITLE anything 

.ABS NLD 

.LOC 234 

734777 

6J0J3261 

.LOC 35j3 

-3 

.LOC 371 

j34^674 


.END 


MEANING AND OPERATION PERFORMED 


No Loader. 

Set location counter to address 234, 
Set contents of 234 to 734777, and 
go to next location. 

Set contents of 235 to 600261 . 
Advance counter to location 35j0. 

Set contents of 35j3 to -3. 

Advance location counter to 
address 371. 

Write 040674 into LOC 371 


End program. 


As illustrated in the above example, .LOC statements in the patch 
program are recognized by PATCH as pointers. These pointers direct 
PATCH to start a replacement operation at a specified address in the 
program or data block being patched. In the replacement (overwrite) 
operation, the contents of the Patch File location immediately follow- 
ing the .LOC statement is written, by PATCH, into the selected program 
or data block location pointed to by the .LOC address. PATCH then 
writes, in sequence, the contents of the following Patch File locations 
into the registers of the file being patched immediately following the 
one pointed to by the patch file .LOC statement. All patches are 
written as if the program is to be loaded into the first bank (13 
bit addresses) . All transfer vectors in a .ABS program must be 
bank-bit initialized before use. 
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The current replacement operation continues until another .LOG state- 
ment is reached in the input Patch File. The new .LOG statement ends 
the current replacement operation and directs PATGH to go to a new 
start location and to start another replacement operation. 

The Patch File operations are terminated when PATGH reaches the PATGH 
File .END statement. 


4.4.1 Partial Overlay Patch Programs 

A Patch Program written to change the contents of specific locations 
or groups of contiguous locations throughout a selected program or 
data block acts as a partial patch to the file being modified; only 
those items specified in the Patch Program are affected. The Patch 
Program in example in paragraph 4.4 represents a partial patch. 

Patch programs may only be used to change the contents of registers 
already existing within a selected program or data block; they cannot 
be used to insert information between existing program lines. 

4.4.2 Replacing Gomplete Programs or Data Blocks 


Patch Programs may be written to replace an entire absolute System 
Program or 400g'-word data block. To accomplish this, the user sets 
the first Patch File .LOG statement to point to the first location 
of the program ordata block to be replaced and follows it with the 
replacement program or data block. For example: 


.TITLE 

.ABS 

.LOG 

Replacement 
Program or 
Block 

I 

I 

.END 


(Patch Program name) 

NLD 

(First Location of selected program or 
data block) 


4.5 PREGAUTIONS TO BE OBSERVED FOR PATGH READ OPERATIONS 

The PATGH READ load operation does not modify (i.e., update) SYSBLK on 
completion of the function. If any changes are made to a System Program 
which affect the parameters stored for it in SYSBLK, the user must 
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change ttiese parameters using the PATCH List function (described in 
Section 5). Indexed instructions are not permitted. 

When overlaying a complete program with a new version, the user must 
ensure that the new version will fit into the area allotted to that 
program during SGEN. All .ABS program transfer vectors must be bank- 
bit initialized by the program itself before it uses them if the core 
image is loaded above 8K. 
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SECTION 5 


LISTING AND MODIFYING PROGRAM AND DATA BLOCK REGISTERS 


5.1 REGISTER MODIFICATION FUNCTIONS 

This section describes the functions, commands and procedures which 
enable the user to select and m-odify individual registers within; 

al SYS files initially written as absolute programs, 
bl READR-installed SYS files, 

c] a system device SYSBLK Program Parameter Table, and 

d) a system save, fQAREA, area. 

5.2 PATCH LIST FUNCTION 


PATCH register modification is carried out as a list operation in 
which the address and contents of each register selected by the user 
are listed (printed) on the user's console teleprinter. On completion 
of the print operation, the user may enter, if desired, an expression 
to replace the contents of the currently listed register. When the 
user is through with the currently selected register, he teirminates 
that operation and either terminates, the function or directs PATCH 
to list the contents and address of another register. The program 
or data block containing the register (s) to be modified must be 
identified by the entry of a Select command (see Section 2) ; the 
specific register to be viewed and modified (if desired) is selected 
by the user with a "List" command. Three types of List commands are 
provided by PATCH: 


a) L command , used to select and initiate the list 
operation for registers within any selected SYS- 
file, data block, SYSBLK or QAREA contained by 
the device on .DAT -14. 

b) LR command , used only for the selection and list- 
ing of registers within READR-installed SYSfiles. 

c) SYSBLK Program Parameter Commands , five separate 
commands, each of which initiates the list opera- 
tion for a specific SYSBLK parameter for the cur- 
rently selected SYSfile. Used only with SYS files 


The tormat and use ot the above List commands are described in para- 
graphs 5-3, 5-4, and 5-5, lEspectively . 
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5.2.1 List Operation 


The PATCH operations performed during a List operation are: 

al On the entry of a list command, PATCH loads the 400g 
word data block or selected Program block containing 
the user identified register into core. The selected 
register is opened by PATCH and its address and con- 
tents are printed on the console teleprinter unit. 

bi PATCH waits for the entry of a modifier and/or a 
terminator. 

cl PATCH writes the input modifier (if made) into the 
opened register and examines the line terminator to 
determine the next operation to be performed. De- 
pending on the terminator entered (see 5.2.3) PATCH 
terminates the List function or opens another 
register. 

5.2.2 Expressions 

Expressions, as defined for MACRO-15 (see DEC-1 5-AMZA-D) , are strings 
of symbols and numbers separated by arithmetic or Boolean operators. 
Octal numbers of from one to six digits {Sf to 777777g) or alphanumeric 
symbols of from one to three characters may be used as expressions or 
as components of an expression. 

Xn PATCH List operations, expressions are entered as replacements for 
tPie contents of a program or data block register. Expressions entered 
to change or modify a data word consist of up to six octal digits, 
originally preceded by a minus sign; those entered for an instruction 
word consist of an instruction operation code and an operand. PATCH 
contains symbol tables for all of the PDP-15 basic instructions op- 
codes and the operate group instructions with the octal values of 
each. The user can, therefore, patch registers using symbolic rather 
than octal representations of MACRO instructions (e.g., an expression 
may be entered as LAC 17536 instead of its octal form, 217536). 

The operators recognized by PATCH are listed in Table 5-1. 
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TABLE 5-1 


Operators Recognized by PATCH 

FUNCTION 

Two's complement subtraction 
Inclusive OR 

Two ' s complement addition 


The asterisk (*) in addition to its use as an operator, also sets the 
indirect bit of the expression by causing 20000^ to be XORed into the 
value of the expression. The XOR operation occurs each time that the 
symbol (*) is encountered; two sequential asterisks negate the setting 
of the indirect bit. 

** = 20000 XOR 20000 = 0 

The value of a PATCH expression is null Cno modification is made to 
the opened register) unless the expression contains a number, symbol 
or an asterisk. 

Expressions are evaluated from left to right assuming an initial value 
of zero followed by a + operator (i.e., 0 + User's expression). Lead- 
ing and trailing operators are legal in an expression but the latter 
are ignored. Whenever a string of consecutive operators is used, only 
the last one in the string is used by PATCH in evaluating the expression. 

NOTE 

The LAW symbol is a special case in PATCH; it should 
be used only in the following ways: 

a) LAW^n which is equivalent to 7 60000+n 

b) LAW. , -n which is equivalent to -n. 

The use of LAW in any manner other than that described 
below will result in an error. 


OPERATOR 


• 1 

V 

H Ctab 1 I 
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5.2.3 List Operation, Line Terminator 


When all list operations for an opened register are completed, one of 
four possible Line Terminators is entered to close the register and 
indicate the next list operation. The line terminators are described 
in Table 5-2. 


Table 5-2 List Operations, Command String Terminators 


ENTRY 


DESCRIPTION 


OPERATION 


t j 




Carriage Return 


Open and list the next sequential 
register 


Up Arrow and Carriage Open and List the register which 
Return precedes the current register. 

Treat any entries after + as a 
comment . 


Back Arrow and Car- 
riage Return 


ALT MODE 


Open and list the contents of the 
register pointed to by the address 
portion of the word contained in the 
currently opened register. Treat 
any entries after ■<- as a comment. 

Terminate current list operation; 
write PATCH buffer block onto 
.DAT -14 and wait for next entry. 


5.3 L List Command 


The L List command has the following format: 


Lwjn) 


where 


a) L initiates the list operation, and 

b) n represents the octal form of the 13-bit address of 
the location to be opened. When the L command is used 
to open registers of READR-installed SYS files the 
address n must be the relocated (i.e., address after 
relocation) value. 
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The response to an L command is a printout having the following format 


>address of opened location) / (contents of opened location) > 

EXAMPLE 

>L 132 

>j2f0132/777435> (location 132g; contents 777435g) 

After outputting the address and contents of the accessed location, 
PATCH prints its go-ahead symbol (>) and waits for: 


1) the entry of an expression to replace the current con- 
tents, to modify the opened location. 

For example: 

> (address) / (current contents) > (expression-new contents) 

2) the entry of selected string terminator to indicate the 
next sequential list operation. 


5.3.1 Example: Select, List and Modification Procedures 


The following illustrates the use of PATCH select and list commands in 
the modification of a hypothetical system program named JOVE. 


PROCEDURE 


DESCRIPTION 


> JOVE 
> L 100^ 

ij00100/777435> ^ 

. .00101/600200> 213775 ^ 

i _,0 0 10 2/ 1 1 1 2 1 5 > 003000 


cj00300/000110>t J 


Select System Program JOVE. 

Initiate List operation starting at loca- 
tion 100 

PATCH prints address and contents of 
opened location; user enters ^ to go to 
and open next sequential location. 

Address and contents of location 101 are 
printed, user changes contents from 
600200 to 213775 and opens the next sequen- 
tial location. 

User modifies contents of location 102 and 
commands PATCH to go to and open the loca- 
tion addressed by the contents of location 
102 (i.e., location 300). 

User enters i ^ to open and examine con- 
tents of preceding location (i.e., 277). 


00277/703112>@ 


> 


User terminates current list operation 
by entering ALT MODE (symbol @) . 

PATCH prints a go-ahead symbol to indicate 
that it is ready for the next operation. 
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5.4 LR LIST COMMAND 


The LR List command has the following format: 

>LR n) 

where LR initiates the listing operation for a previously selected 
READR-ins tailed Systems Program, and n represents the 13 bit "unrelo- 
cated" address (in octal) of Ihe program location to be opened. 


NOTE 

PATCH automatically calculates and adds the needed 
relocation factor to the user's entry (i.e., n) . 

This enables the user to work directly from origi- 
nal unrelocated listings. 

The major difference between the "L" and "LR" list operations is that 
in L operations only absolute address information is output in responses 
and is required in modification procedures. In LR operations, however, 
the user must deal with both relocated and unrelocated addresses in 
list printouts and in register modification procedures. 

When the LR command is used to open word locations containing either 
data or non-memory reference instructions, the responses output are 
similar to those described for the L command. The only difference is 
that in the LR responses the address of the accessed location is given 
in relocated form relative to the original MACRO-as signed address. 


NOTE 

In the following paragraphs the symbol # is used to 
denote the relocation factor used by PATCH in the 
conversion of an unrelocated program into a system 
program. 


To illustrate, assum‘=! that 6 is the unrelocated address of a user- 
selected location containing a non-memory reference instruction or data 
and that the relocation factor (#) is 17344. The response to the 
command: 
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>LR^6 ) 


is printed in the following form: 

>17344 + 6 / nnnnnn > 

Relocated Contents of location (6 digits) 

Address Op-Code and Operand or Data 

For example; 

>17352/017206> 

To illustrate, assume that a relocation factor of 17642 is current and 
that the selected program location 101 contains a JMP .+1 instruction. 

The response to the command: 

LR.__,101) 

is printed in the following form: 

17743/617744<00102> 

Relocated Contents, Op-Code + # + Operand Unrelocated Operand, 

Location (600000 + 17642 + 102 Referenced Address 

Address JMP=600000 (i.e., 00102) 

(177642+101) .+1 = 101+1 = 102 

Printing an address operand in its unrelocated form enables the user to 
easily recognize the instruction containing it, and the referenced lo- 
cation without calculating and subtracting the PATCH relocation factor 
(#) . 

The unrelocated referenced address within a memory- reference type instruc- 
tion is not printed by PATCH if it is less than the first address of the 
program; the address printed in angle brackets is always positive, though 
it may be zero. 

5.4.1 LR, Register Modification Procedure 

The contents of registers opened during LR operation are changed, as 
for L list operations, by the entry of an expression which is to re- 
place the contents of the current location.. New contents are entered 
immediately after the listed response and replace the current contents 
on termination of the response/user-input line. 
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Input expressions are formed using: 


a. Octal numbers up to six digits in length; 
PATCH always assume a six-digit input and 
right- justifies all numeric inputs (e,g. , 
an entry of 300g is recognized as OOOSOOg) . 

b. Operators (symbols) as listed in Table 5-1. 

c. Symbolic representation of all PDP-15 basic 
instruction op-codes and operate group in- 
structions . 

d. The symbol # to represent the relocation 
factor of the currently selected, READR- 
installed System Program. 


Command string terminators indicate the next sequential operation to 
be carried out (refer to Table 5-2) . 

5.4.2 Relocation and LR List Operation Examples 

The following examples use a single memory reference instruction to 
illustrate the relocation operations perfomed by READR in the instal- 
lation of a SYS file andthe manner in which the instruction may sub- 
sequently be examined using the LR command. 


EXAMPLE: 


a. Assume the instruction LAC. .300 located in MACRO as- 
signed location 200 of an unrelocated 400o-word pro- 
gram. 

b. The program is selected by the user and is tched 
onto a prepared system device medium as a SYS file 
using the READR function/ command. 

Program >Filename (name given at SGEN time) 

Name >READR Filename (current name of program) 

c. During READR operations, a relocation factor is cal- 
culated and added to all location addresses contained 
by the program. For a 400g-word progreuu # = 17237g. 
Therefore, the relocatable® input memory reference 
instruction 

200g LAC 300 

is relocated as 

(#+200) (LAC #+300) 
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which equals 


17437g LAC 17537g 

or, in full octal fom: 

17437 217537 

The relocated instruction is then output to the system 
device. 

d. To examine the instruction given in step c. in a READR- 
installed SYS file, the user calls PATCH, selects the 
program, and uses the LR command 

$ PATCH 
>Filename 

>LR^_j20Q) 

The responses output at the I/O console will be: 
>17437/217537< 0j3300> 

e. To change the contents of the location, the user enters 
the desired expression and terminates the command string. 
If the contents contain an address, the relocation factor 
must be added to the new entry. 

For example, to change the address references in the con- 
tents of the location opened in step d from the 300g to 
305g Cunrelocated values), the user must enter the expres- 
sion: 

217544g 

if he knows the value of the relocation factor # (i.e. , 
17237 + 305) , 

or 


LAC #+305g 


EXAMPLE : 


>17436/217537< 00300> LAC#+3)?5 ) 
changes the location to 
17436/217544 

/ 

and the terminator ^ causes the next sequential loca- 
tion to be opened and a response output. 
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5.5 SYSTEM PROGRAM SYSBLK PARAMETER COMMANDS 


PATCH provides, as a convenient for the user, five separate commands 
which obtain and modify, if desired, SYSBLK parameters for the user 
selected program currently in core. By entering the appropriate com- 
mand from the following list and using suitable terminators as listed 
in Table 5-2, the user may start the listing at any specific point and 
proceed subsequently through the desired parameters. 

The commands, the parameters opened, and the word positions are as 
follows : 


Command 

SYSBLK Parameter Opened 

Word Position 

a) FB J 

Number of first block used 

3 

b) NB.J 

Number of blocks allotted to 
program 

4 

c) faJ 

First core address occupied 
when the SYS file is loaded 
into core (13-bits) 

5 

d) PSJ 

Program Size 

6 

e) SA ) 

Starting Address (13-bits) 

7 


When examining the parameter group of a READR-installed System Pro- 
gram, the user must remember that: 


FA will give the address of the first (lowest) 

core locations occupied by the System Pro- 
gram/BBI combination when it is loaded. 

PS will give the TOTAL size of the System 

Program/BBI combination. 

SA will give the starting address of the BBI 

routine (first address above Transfer Vec- 
tor address table) . 


NOTE 

The program system parameter commands may not be used: 

a. when a program has not been selected or 
the command CTRL P (tF; has been entered; 

b. when SYSBLK has been selected; 

c. when the commands B, B+, or B- are in ef- 
fect. 
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The five SYSBLK Parameter commands operate in a manner similar to the 
List (L) command. When entered, the corresponding parameter location 
address and contents are printed out followed by a go-ahead symbol (>) 
as for the L command. As in other list operations, the user may, ac- 
cording to the manner in which terminators are used: 1) modify the 
opened register, 2) view the next sequential register, 3) view the 
preceding register, 4) jump to and view the location addressed by the 
contents of the last opened register, or 5) terminate the operation. 

The operations initiated by a Parameter command are carried out on the 
SYSBLK information contained by the PATCH command table. This SYSBLK 
data is obtained by PATCH when it is first loaded into core and prior 
to the start of user PATCH operations. ’ On completion of each SYSBLK 
Parameter command operation (ALT MODE terminator used) , the modified 
(or unchanged) command table SYSBLK is copied onto the system at .DAT-14. 

Five separate commands are provided by PATCH as a convenience for the 
user; they pemit the user to obtain a specific parameter or to start 
listing operations at a specific point with a simple straightforward 
command. The complete series of five program parameters may be ob- 
tained simply by starting with the FB command and advancing the list- 
ing operation through the next four sequential word locations . This 
method is the only way to modify .SYSBLK parameters without reloading 
PATCH since it also modifies the PATCH command table. 

EXAMPLE: 

The following example illustrates the use of a PATCH SYSBLK parameter 
command to obtain and modify the first address occupied, program size 
and starting address parameters for the system program currently in 
core. 


> faJ 

00066/013670>13660 J 

00067/003747>3757 J 
00070/013671>136ei (ALT MODE) 


parameter command 
first address opened and modi- 
fied 

program size opened and modified 
starting address opened and 
modified and operation termi- 
nated. 
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SECTION 6 


SUMMARY, OPERATING PROCEDURES AND ERROR MESSAGES 

6 . 1 CONTENTS 

Brief procedural descriptions of the operations needed before loading 
the PATCH program and for the performance of each PATCH function are 
given in this Section. Error detection and error messages are also 
described. 


6 . 2 PRE-LOAD OPERATIONS 


6.2,1 .DAT Slot Assignments 

The user must make the .DAT slot assignments given in Table 6-1 
immediately prior to loading the PATCH program. 


Table 6-1 Required .DAT Slot Assignments 


.DAT Slot 


Used to 


-14 


-10 


Permanently 

Assigned 



Input from and output to the device 
on which patches are to be made. 

The device handler is required only to 
perform .TRAN. 

Input from the auxiliary device. 

The device handler must handle Dump 
Mode input and, if it is for a non- 
file oriented device, must handle 
image alpha mode. 

Output to the teleprinter. 

Input from the console keyboard or batch 
processing device. 


.DAT slot -10 can be assigned no device handler (NONE) if auxiliary 
input is not required. .DAT slots -3 and -2 cannot be changed. 

6.2.2 I/O Device Preparation 

The user must ensure that the I/O device assigned to .DAT-14 
(material to be patched) is WRITE ENABLED before starting PATCH 
operations . 
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If the device is a 


1. DECtape unit - set the unit's WRITE ENABLED/WRITE LOCK 
switch to the WRITE ENABLED position. 

2. DECdisk - set the assigned logical disk unit's WRITE 

LOCKOUT switches to their ENABLED positions. Disk units only) 

6.3 CALLING PATCH 

PATCH is called by issuing the command PATCH from the system I/O 
console. When PATCH is loaded and running, it outputs its name 
and version number. For example: 

KM15 V5A 
$PATCH^ 

PATCH Vnn 
> 

6 . 4 PATCH OPERATIONS 

The operations which may be performed using PATCH fall into four (4) 
functional groups. Procedures, in table form, are given for the List 
"L" and "LR" functions. 

6.4.1 Examination and Modification of Registers in Absolute Programs 
and Data Blocks 

See Table 6-2. 

6.4.2 Examination and Modification of Registers in PATCH- READR-ins tailed 
System Programs 

See Table 6-3. 

6.4.3 Replacing Absolute Programs from External PATCH Files 
The required procedure is to: 

a. Select Program or data block to be patched (e.g. >EDIT^). 

b. Specify READ operation and input file with the command 
string 

> READ filename]^ (e.g., >READi_^DPCH^) 
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A A Tnc-t-alla-J-T on TD-K-f^z-ryarn*^ 

„ Z, * Z. - — ^ ^ W>3 J. i-l^Ll.J 

The required procedure is : 


CVC TPA 1 

w a. 1^ j. .U JL^O 


a. Select the system device area prepared (by SGEN) to 
receive the new SYS file (e.g. , >NUFIL ^ ) . 

b. Enter the PATCH READR command using the following 
format : 

>READRi_jnnnnn i_j[f ilename]^ (e.g., >READR|_jl76j2f0i_jNUFIL^) 

NOTE 

nnnnn represents the highest register the new SYS 
file will occupy when loaded into core. In the 
example, this is specified as llSfSjS^ which would 
leave a 36g-word buffer between the ° top of the SYS 
file and °the first Bootstrap location. 


6.5 ERROR DETECTION 

PATCH, on the detection of an error, causes the following: 


1) the current function is terminated; 

2) the data block (program or selected block) current in 
the PATCH Block Buffer is output to the device at 
.DAT-14 if modifications had been made to the block; 

3) an appropriate error message is output at the user's 
I/O terminal. 


In the event of an .lOPS error, control is not automatically returned to 
the monitor. PATCH can be restarted by the entry of a CTRL P (fP) 
command. CTRL P is also useful in terminating a read operation in the 
event of an equipment malfunction (e.g., paper tape reader jams). 

In the event of an "I/O device not ready" error (I0PS4) , CTRL R may be 
used to continue the current operation after the device involved has 
been made ready. CTRL C may also be used to return control to the 
monitor; however, care must be taken not to use this command when a 
register is open since any modification made to the current block in 
core will be lost. 


6,6 ERROR MESSAGES 


The error messages output by PATCH are listed and described in 
Table 6-4. 
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Item to be Patched 


Operation 


BLOCK 

PROGRAM 

> B. .n^ or 

>Prog. Name^ 

> B+ , n J or 


t_j ^ 


> B- . nJ 


L_l ^ 


> L , n ^ 

> L n ^ 

u-i 

U-l 


PROGRAM 

SYSBLK 

PARAMETERS 


SELECT ITEM 
TO BE 
PATCHED 


>Prog. Name^ 


SELECT 
REGISTER OR 
PARAMETER 


MODIFY 

OPENED 

ITEM 


>faJ 

or 

>FB J 

or 

> NB 5 

or 

> PS J 

or 

> saD 



ENTER NEW CONTENTS IMMEDIATELY AFTER RESPONSE 
OUTPUT WHEN LOCATION WAS OPENED. 

e.g., > Address/ Old Contents > New Contents 


SELECT 

NEXT 

OPERATION 


TERMINATE RESPONSE LINE ACCORDING TO DESIRED NEXT 
OPERATION: 


^ go to next sequential location open 

and list address and contents 


t ^ go to preceding register, open and 

list address and contents 

^ go to register identified by contents 
of current register, open and list 
address and contents 

ALT terminate current list operations 

MODE 


Table 6-2, Procedure for Modifying Registers in Absolute System Programs 
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To B© Pstciisd 



PROGRAM 

PROGRAM SYSBLK 

PARAMETERS 

SELECT ITEM 

>Prog. Name^ 

>Prog. 

Name_^ 

SELECT REGISTER OR 

>LR n J 

>PA ) 

or 

PARAMETER 

i—j 

>FB J 

1 

or ! 



>NB-.^ 

or 



>PS J 

or 



>saJ 



ENTER NEW CONTENTS IMMEDIATELY AFTER RESPONSE 
OUTPUT WHEN LOCATION WAS OPENED. USE RELOCATION 
FACTOR (#) WHEN CHANGING MEMORY REFERENCE OR 
TRANSFER VECTOR REGISTERS. 

e.g . , standard register 

^ relocated .old ^ new 

address ' contents contents 

memory reference instruction or transfer 
vector 

^ relocated . old ^unrelocated^ new 

address ' contents address of contents 

contents + # 


TERMINATE RESPONSE LINE ACCORDING TO DESIRED 
NEXT OPERATION: 

^ go to next sequential location 

open and list address and con- 
tents 

go to preceding register, open 
and list address and contents 

go to register identified by 
contents of current register, 
open and list address and con- 
tents . 

ALT terminate current list operations 

MODE 


SELECT NEXT 
OPERATION 


MODIFY OPENED 
ITEM 


Table 6-3. Procedure for Modifying Registers in PATCH-Installed System 
Programs 
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Table 6-4 


Printout 

ILLEGAL COMMAND 

NOT OCTAL DIGIT 

TOO MANY DIGITS 

ADDRESS OUT OF RANGE 

CHECKSUM ERROR 

FILE NOT FOUND 

ILLEGAL BLOCK # 

ILLEGAL SIZE 

MORE THAN 256 

TRANSFER VECTORS 

NOT RELOCATABLE BINARY 

.GLOBL NOT ALLOWED 

LAST ADDRESS GREATER 
THAN 17636 


ERROR MESSAGES 


Meaning 


a. An attempt was made to issue a command 
before a file or block was selected. 

b. Command unrecognizable. 

A character other than an octal digit was 
encountered where an octal digit was 
expected. 

The command string contains an octal number 
with more than 6 digits. 

a. The address requested is not within the 
legal range of the currently selected 
program or block. 

b. Address or size argument of a SYSBLK 
command is greater than 17645„ or is 
negative. 

Bad data read in from auxiliary input device 
(checksum, parity, or validity bits) - try 
again . 

The file named in a READ or READR command does 
not exist on the auxiliary device. 

The block number specified in a Block 
Selection command was less than 0 . 

a. The program size (PS command) exceeds the 
number of blocks allotted for the current 
program. 

b. The size of the program (including the 
bank bit initialization routine supplied 
by PATCH) input by a READR command exceeds 
the number of blocks allotted (during 
system generation) for the SYS file or 

is greater than nnnnn-20 . 

O 

The program being input by a READR command 
contains more than 256 transfer vectors. 

The program being input by a READR command 
is not a relocatable binary file. 

The program being input by a READR command 
contains an external .GLOBL (internal .GLOBL 
ignored) . 

The last address of the program input by a 
READR command is greater than 17636-,. 

O 
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APPENDIX A 


SYSTEM BLOCK (SYSBLK) DESCRIPTION 


A.l SYSTEM BLOCK (SYSBLK) 

In each of the primary PDP-15 monitor systems (ADSS, DOS) the monitor 
contains a System Block table (abbreviated as SYSBLK) which contains 
the name, physical parameters and 1/0 infomation for each system pro- 
gram in the software system. 

The information contained by SYSBLK in the initial operating system is 
determined during System Generation procedures (refer to the appropri- 
ate SGEN manual - Table 1-1) . SYSBLK is used by the system loader 
programs in locating and loading selected (called) System Programs into 
core. 

PATCH, when first loaded into core, checks for a SYSBLK at .DAT -14 and, 
if one is present, it loads the SYSBLK Parameter Table into core as a 
PATCH Command Table. This command table is used unchanged during all 
subsequent PATCH System Program operations, including SYSBLK modifica- 
tion operations . 

SYSBLK, itself, is divided into two distinct areas (see Figure 2-1) , a 
Parameter Table, and a Communications Table (named COMBLK in DOS systems) . 
PATCH operations nomally concern only the SYSBLK Parameter Table. 


ADSS 


SYSBLK 


r 



PARAMETER 

mTV pr pq 




FREE AREA 


COMMUNICATIONS 
DATA GROUPS 



< 




J 


DOS 


SYSBLK 


COMBLK 


Figure A-1 

System Block, Overall Configuration 
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A. 1.1 SYSBLK Parameter Table 


Both the ADSS and DOS SYSBLK parameter tables contain separate seven- 
word parameter groups for each System Program in the operating system. 
Each parameter group consists of the following: 


WORD CONTENTS 

1 & 2 Name of the System Program or overlay (i.e., PATCH, 

DDT, EDIT, etc.) in .SIXBT. 

3 The number of the first system device block occupied 
by this System Program or overlay. 

4 The amount of system device blocks allotted to con- 
tain the program. For PATCH-ins tailed programs, this 
number is alio t ted dir ing user SGEN procedures. 

5 The address (13-bit) of the first core locations that 
will be occupied by the System Program when it is 
loaded. 

6 The size of the program. 

7 The program starting address (13-bit) . 


An example of an ADSS System Program parameter table is given in 
Figure 2-2. 

OCTAL 

PRINTOUT 


WORD 

CONTENT 

INTERPRETATION 

00010 

00011 

050411 

240000 

Program name "EDIT" in .SIXBT code. 

00012 

000630 

The first block occupied by EDIT is 
630g. 

00013 

000012 

Twelve blocks (octal) are allotted to 
hold the program EDIT. 

00J314 

013000 

The first core location^ occupied by 
EDIT is 13000g. 

00015 

004636 

EDIT consists of 4636g words. 

00016 

013000 

Program start address^ is at core loca 


tion 13000Q. 


Figure A-2 


System Program EDIT SYSBLK Parameter Group 


^At load time, the bank bits of the highest 8K system bank are added to 
this address to properly locate the program in the highest' bank. 
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A. 1.2 Coramuni cat ions Table 


ADSS system block communication areas contain individual .DAT slot lists 
for each system program and a master .DAT slot list pointer table. 

DOS system block COMBLK area contains individual communication data 
groups which store .DAT slot, buffer, and overlay information for 
each system program. 
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APPENDIX B 


SYSTEM PROGRAMS, GENERAL DESCRIPTION 


System Programs have a unique feature in that they are loaded into 
core and are started by only the entry of a single user command (i.e. 
program name) at the system ocnsole keyboard. This feature is imple- 
mented by name, control paraiTiSters , and I/O device information con- 
tained for each System Program in the system SYSBLK Parameter and 
Communication CCOMBLK) tables. The information contained in SYSBLK 
enables the Keyboard Monitor to recognize System Program names (as 
stored in SYSBLK) and causes it to initiate the loading of the identi 
fied program into core. 


System Programs and their associated Device Handlers are loaded into 
core from the system device by the System Loader (.SYSLD) program. 

The placement of System Programs and their device handlers in core is 
illustrated in Figure 2-3. As shown: 

1) System Programs are always loaded immediately below the 
Bootstrap in the highest portion of the highest 8K bank 
in the system. 

2) In systems which include an extra 4K page (e.g. , 12K, 

20K, 28K, etc.) the extra 4K portion is used, during 
loading operations, only for handlers. 

31 The lowest register which a System Program may occupy 
is 20g in the highest 8K bank of the system; handlers 
and free core may be located anywhere in the system. 

System Programs are stored on the ^stem device as absolute executable 
files identified by the file name extension "SYS" and are commonly 
referred to as "SYS files". Software is supplied to the user and 
contains a standard group of commonly used utility and language pro- 
grams installed on some medium (e.g., DECtape) as SYS files. The 
SGEN and PATCH utility programs can be used to delete the supplied 
SYS files or replace them with other Digital-supplied programs or 
with user programs. Table 2-1 lists the names and SYSBLK entry 
names of the System Programs supplied with PDP-15 software systems. 
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EXTRA • 
4K PAGE I 


BOOTSTRAP 


SYSTEM 

PROGRAM 

CSYSfile) 


DEVICE 

HANDLERS 


RESIDENT 

MONITOR 


.17777g + N 
17636g + N 


^ SCOM + 3 


^ 000200 + N lower limit 

for SYSfile 


.SCOM + 


2 


.SCOM + 1 


0 


LEGEND: 


N = 00000 for 
= 20000 for 
= 40000 for 
= 60000 for 


8K systems 
16K systems 
24K systems 
32K systems 


Figure B-1, Memory Map, Loading System Programs 
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INDEX 


.ABS macro program, 4-2 
Absolute address information, 5-6 
Absolute address values, 3-3 
Absolute files transfer, 4-1 
ADDRESS OUT OF RANGE error, 4-2 
Address relocation, 3-2 
Addresses in LR List operations , 5-6 
ALT MODE, 5-4 

Asterisk (*) symbol, operator, 5-3 
At symbol C@) (ALT MODE), 5-4 


B command (Block Select) , 2-3 

Bank Bit Initialization routine, 

3-2 through 3-5 

vjord location requirement, 3-5 
Batch control operation, 1-1 
Block relocation, 2-3 
Block Select (B) , 2-3 

command, 4-2 


Calling PATCH, 6-2 
Changes to SYSBLK parameters, 4-4, 

4-5 

Command , 

B, 2-3 
L, 5-4 
LR, 5-6 
READ , 4-1 

READR, 3-1, 3-2, 3-3 


SYSBLK 

commands 

FA, 

5-10 

fb. 

5-10 

NB, 

5-10 

PS, 

5-10 

SA, 

5-10 

Commands 

/ 

Block 

Select, 


Program Select, 4-2 
Select, 5-1 
SYSBLK, 5-10 
Comments, 2-3 
Common data storage, 3-5 
COMMON references, 3-2 
Communications Table, A-3 
Conversion of relocatable file 
to absolute SYS file, 3-1 
Core image size, 3-2 
CTRL Q area ( i QAREA) , 2-1 


.DAT slot assignment, 1-3, 6-1 
•DAT slot lists, A-3 
Data flow paths, 1-3, 1-4 
DECdisk preparation, 6-2 
DEC tape preparation, 5-2 
Device assignments, 6-1 
Disk preparation, 6-2 


Documents, supporting, 1-2 
Dump Mode, 6-1 


Error , 

address out of range, 4-2 
detection, 6-3 
messages, 6-6 

Evaj-Uauion of expression, 5—3 
Examples of Select, List and 

Modification procedures, 5-5 
Examples, Relocation and LR List 
operation, 5-8, 5-9 
Exclamation point symbol (!), 
operator, 5-3 
Expressions, 5-2 
evaluation of, 5-3 
null, 5-3 


File conversion, relocatable 
to absolute, 3-1 
Filename extension, READ 
command, 4-2 
Filename omission, 3-1 
Filename, paper tape files, 4-2 
Function, 

List, 5-1 
load , 3 -1 

READ load, 4-1 
Select, 2-1 

Functions of PATCH, 1-3, 6-2 


.GLOBL references, 3-2 
Go ahead symbol (>) , 5-5 


Identification of program, 2-1 
linage alpha mode, 6-1 
Inclusive OR, 5-3 
Indexed instructions, 3-2 
Input devices, 1-1/ 6-1 
Input expressions for register 
modification, 5-8 
Input file requirements, 3-2 
I/O device preparation, 6-1 
I/O data flow paths, 1-3, 1-4 


LAW symbol, 5-3 

Linking Loader system program, 3-3 
List function, 5-1 
L command, 5-1, 5-4 
LR command, 5-1, 5-6 
SYSBLK parameter command, 5-1 

5-10 

List operation, 5-2 
line terminator, 5-4 
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L List command, 5-4, 5-5 
LR List command, 5-6 

register modification procedure , 5-7 
Load address specification, 3-5 
Load function, 3-1 
Loading absolute programs, 4-1 
Loading relocated core image 
system programs, 3-6 
.LOG statements as pointers, 4-3 


MACRO 15 assembler, 3-3 
Major functions of PATCH, 1-3 
Memory Map, READR SYS file, 3-7 
Messages, error, 6-6 
Minus sign (-) operator, 5-3 
Modes , 

dump, 6-1 
image alpha, 6-1 


Naming program, 2-1 
Null expression, 5-3 
Number symbol C# ) usage (relocation 
factor symbol), 3-3, 5-6, 5-8 


Operators recognized by PATCH, 5-3 
Output device, 6-1 


Parameter changes, SYSBLK, 4-4, 4-5 
Parameter table, SYSBLK, A-2 
Partial overlay PATCH programs, 4-4 
Plus sign (+) operator, 5-3 
Pointers C-LOC statements) , 4-3 

Pound symbol (#) usage (relocation 
factor symbol), 3-3, 5-6, 5-8 
Precautions, READ operations, 4-4 
Preload operations, 6-1 
Procedure for modifying registers, 
in absolute system programs, 6-4 
in PATCH installed system 
programs, 6-5 
Program 

name, 2-1 
size, 3-2, 3-3 
writing, 4-3 

Program Select command, 4-2 


Relocation factor, 3-3, 5-6 
symbol (#), 3-3, 5-6, 5-8 

Relocation operation, example 
LR command, 5-8, 5-9 
Replacement (complete) of 

programs or data blocks, 4-4 
Right angle bracket (>) (go- 
ahead symbol) , 5-5 

Routine, Bank Bit Initializa- 
tion, 3-2 through 3-5 


Select command, 5-1 
Select function, 2-1 

Block Select (B) command, 2-3 
Program Select command, 2-1 
SGEN utility program, B-1 
procedures, 3-1, 3-2 
Size 

of core image, 3-2 
of program, 3-2, 3-3 
Summary, 6-1 

Supporting documents, 1-2 
SYS files, B-1 
SYSBLK parameters, 3-2, 4-1 
changes, 4-4, 4-5 
commands, 5-10 
command example, 5-11 
table, A-2 

SYSBLK (System Block), 2-1, A-1 
.SYSLD (system loader), 3-4, 3-6, B-1 
System Block, see SYSBLK 
System generation procedures 
(SGEN) , A-1 

System Loader (.SYSLD) program, 

3-6, B-1 

System programs, loading, B-1 
System Program SYSBLK parameter 
command s , 5-10 

System programs supplied with 
DOS and ADSS, 2-2 

Tab symbol ( -*| ) , 5-3 

Termination of PATCH operations , 4-4 
Terminators, list operation 
command string, 5-4 
Transfer vectors, 3-2 
data word format, 3-4 
Two'^s complement addition, 5-3 
Two's complement subtraction, 5-3 


READ command, 4-1 

load operation, 4-2 Writing PATCH programs, 4-3 

READ operations, precautions, 4-4 
READR file relocation calculation, 

3-3 XOR (exclusive OR) , operator, 5-3 

READR Load command, 3-1, 3-3 
input file requirements, 3-2 
procedures, 3-2 

READR System Communications area, 3 -5 
Register modification functions, 5-1 
Relocatable programs installed as 
absolute SYS files, 6-3 
Relocation of block, 2-3 
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HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PD P-8 & PD P-1 2 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Prc^frim Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 
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of its publications. To do this effectively we need user feedback — your critical evaluation of 
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